DICE API Documentation/com.embabel.dice.storage.model

Package-level declarations

Types

data class DerivedFrom constructor(val chunkId: String? = null, val startOffset: Int? = null, val endOffset: Int? = null, val contentHash: String? = null, val source: SourceNode, val sourceRevision: String? = null, val entryKey: String? = null, val display: String? = null)

The DERIVED_FROM edge from a proposition to a shared SourceNode. The per-proposition span (chunkId, offsets, the entry's own content hash) rides on the relationship; the source itself is the shared node. Together they reconstitute a dice ProvenanceEntry.

Mention

data class Mention(val id: String, val resolvedId: String? = null, val span: String, val type: String, val role: String)

Drivine graph projection of a dice EntityMention: an entity reference within a proposition.

ProcessedChunkNode

data class ProcessedChunkNode(val id: String, val contextId: String, val contentHash: String, val sourceId: String, val startIndex: Int, val endIndex: Int, val processedAt: Instant)

Tracks chunks already processed during incremental analysis, so re-runs skip unchanged content. Keyed by context-scoped content hash (also the node id).

PropositionNode

data class PropositionNode(val id: String, val contextId: String, val text: String, val confidence: Double, val decay: Double = 0.0, val importance: Double = 0.5, val reasoning: String? = null, val grounding: List<String> = emptyList(), val sourceIds: List<String> = emptyList(), val uri: String? = null, val created: Instant, val contentRevised: Instant = created, val metadataRevised: Instant = created, val lastTouched: Instant = maxOf(contentRevised, metadataRevised), val lastAccessed: Instant = created, val status: String = "ACTIVE", val pinned: Boolean = false, val level: Int = 0, val reinforceCount: Int = 0, val embedding: List<Float>? = null, val effectiveConfidence: Double? = null, val decayUpdatedAt: Instant? = null, val validFrom: Instant? = null, val validTo: Instant? = null, val invalidatedAt: Instant? = null, val observedAt: Instant? = null, val supersedes: List<String> = emptyList(), val contradicts: List<String> = emptyList(), val metadata: Map<String, Any?> = emptyMap())

Drivine graph projection of a dice Proposition. The dice Proposition is the system of record; this node is a flat persistence view of it.

PropositionView

data class PropositionView(val proposition: PropositionNode, val mentions: List<Mention> = emptyList())

GraphView composing a PropositionNode with its entity Mentions via HAS_MENTION.

PropositionWithProvenanceView

data class PropositionWithProvenanceView(val proposition: PropositionNode, val mentions: List<Mention> = emptyList(), val provenance: List<DerivedFrom> = emptyList())

The full proposition view: mentions and provenance (DERIVED_FROM → shared SourceNode).

SourceNode

data class SourceNode(val key: String, val kind: String, val display: String? = null, val uri: String? = null, val path: String? = null, val contentHash: String? = null, val connectorId: String? = null, val externalId: String? = null)

Shared graph node for a dice SourceLocator. The @NodeId is the locator's stable key(), so the same source referenced by many propositions is one node (MERGE by key) — reverse-traversable ("which propositions came from this source?") and dedup'd. The polymorphic locator is flattened to a kind discriminator + the kind's fields; reconstructed by PropositionGraphMapper.